Ozon Seller API — программный интерфейс для работы с маркетплейсом Ozon. Он даёт возможность обмениваться информацией между системой продавца и Ozon.

Методы Seller API позволяют изменять данные магазина, например, остатки товаров или их стоимость, и получать данные, такие как информация о возвратах или список складов.

Работа с API состоит из отправки запроса и получения ответа. Для этого можно использовать вкладку Консоль, которая находится сверху описания методов, Postman или настроить интеграцию с системами учёта, например, 1С, ERP или МойСклад.

При интеграции системы учёта продавца с Seller API обновлять и получать данные можно в автоматическом режиме. Это поможет поддерживать актуальной информацию о ценах и остатках товаров, обрабатывать больше заказов за меньшее время и исключить ошибки из-за обновления данных вручную.

Например, вам нужно обновить информацию об остатках или ценах 100 товаров. Чтобы сделать это через личный кабинет, необходимо вручную изменить данные на карточке каждого товара.

Метод /v2/products/stocks позволяет одним запросом обновить информацию об остатках сразу 100 товаров, а метод /v1/product/import/prices — их стоимость.

• Загружать и обновлять товары.
• Управлять ценами и остатками по товарам.
• Получать информацию о возвратах товаров.
• Управлять заказами FBO, FBS и rFBS.
• Управлять чатами.
• Работать с накладными.
• Получать финансовую и аналитическую информацию.
• Получать выгрузку атрибутов и характеристик Ozon.

Перед началом работы с Ozon Seller API:

1. Изучите процессы работы с Ozon в Базе знаний продавца и личном кабинете продавца.
2. Определите процессы, которые планируете автоматизировать, и сравните их с процессами вашей компании.
3. Изучите документацию Seller API и разработайте схему интеграции.

Для работы с Seller API необходим API-ключ. Подробнее в разделе Авторизация.

Seller API работает по UTC. Учитывайте это, когда отправляете запросы и получаете ответы с датами и временем.

Процесс работы с Seller API можно разделить на блоки:

• работа с атрибутным деревом,
• загрузка и обновление товаров,
• управление ценами,
• управление остатками товара,
• управление заказами FBO,
• управление заказами FBS и rFBS,
• работа с накладными,
• получение финансовой информации,
• получение аналитической информации,
• управление возвратами,
• управление чатами.

1. Зарегистрируйтесь в Ozon Seller. Подробнее о регистрации в Базе знаний продавца.
2. Получите API-ключ.

Чтобы получить API-ключ:

1. В личном кабинете перейдите в Настройки → Seller API.
2. Нажмите Сгенерировать ключ.
3. Придумайте название для ключа и выберите его уровень доступа.
4. Нажмите Сгенерировать.

Вы можете создать несколько API-ключей. Например, если у вас несколько пользователей с разными уровнями доступа.

Отредактировать ключ

Если вы хотите изменить разрешённые сети для ключа, в списке API-ключей выберите нужный и нажмите . Внесите изменения и нажмите Обновить.

1. В личном кабинете перейдите в Настройки → Seller API.
2. Удалите текущий API-ключ и создайте новый.

Рабочая среда — это ваш магазин. Все отправленные запросы, кроме информационных, могут изменять данные в личном кабинете и на сайте Ozon.

Рабочая среда: api-seller.ozon.ru

Созданные товары можно посмотреть по ссылке вида: https://www.ozon.ru/context/detail/id/SKU, где вместо «SKU» нужно указать значение для созданного товара.

GET / HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: <Client-Id>
Api-Key: <Api-Key>
Content-Type: application/json

Для проверки корректности формата запроса используйте вкладку Консоль над описанием метода или Postman.

1. /v1/description-category/tree — получите список категорий и типов в виде дерева и используйте значение последнего уровня выбранной категории.

2. /v1/description-category/attribute — получите характеристики для выбранных категории и типа.

3. /v1/description-category/attribute/values — получите список значений для выбранной характеристики.

После сравнения своих атрибутов и характеристик с атрибутной моделью Ozon можете приступить к загрузке товаров:

1. /v3/product/import — загрузите товары и услуги. Этот метод также позволяет обновить уже загруженные товары. В запросе устанавливается первичная цена и загружаются изображения товара.

   В одном запросе можно передать до 100 товаров. Изображения загружаются прямой ссылкой на облачное хранилище, где они хранятся.

   В результате работы метода вы получите task_id — номер задания на загрузку товаров.

2. /v1/product/import/info — проверьте task_id, который вы получили при загрузке товаров. Метод вернёт информацию, успешно ли загрузились товары или при импорте была ошибка.

   Если ответ содержит статус, что товар на модерации, подождите её результатов и проверьте статус товара повторно. Обычно модерация занимает меньше одного дня.

3. /v1/product/upload_digital_codes — загрузите коды активации, если вы продаёте цифровые товары или услуги. Код активации привязывается к карточке цифрового товара. После продажи цифрового товара вы сможете посмотреть привязку кода к отправлению в ответе метода /v2/posting/fbo/get. В результате работы метода вы получите task_id — номер задания на загрузку кода активации.

4. /v1/product/upload_digital_codes/info — проверьте task_id, который вы получили при загрузке кодов активации. Метод вернёт информацию, успешно ли загрузились коды или возникла ошибка.

5. /v3/product/list — получите список созданных товаров после загрузки товаров.

   Метод позволяет использовать фильтры, чтобы разбить товары на группы по статусу видимости или отслеживать изменение их статуса с помощью идентификатора товара.

   Метод возвращает пару значений offer_id и product_id — они нужны практически во всех запросах для идентификации товара, с которым будет производиться действие. Если вы загружали товары через шаблон, используйте этот метод для получения offer_id и product_id, чтобы в дальнейшем работать по API с товарами.

Чтобы добавить изображения товара или заменить существующие, используйте:

1. /v1/product/pictures/import — загрузите или обновите изображения товара. Передайте прямые ссылки на изображения, загруженные в облачное хранилище.
2. /v2/product/pictures/info — проверьте статус загрузки.

Чтобы обновить информацию о товаре и его характеристики, используйте /v3/product/import.

Если нужно обновить только характеристики товара, используйте /v1/product/attributes/update.

• /v3/product/info/list — получите информацию о товаре, например штрихкод, цену главного предложения, идентификатор категории, комиссию или ошибки модерации. С помощью фильтров /v3/product/list получите список пакетно по всем товарам сразу или по категориям.

• /v4/product/info/attributes — получите описание характеристик товара. Метод позволяет добавить дополнительную информацию к товару, чтобы карточка товара была более полной.

• /v1/product/info/description — получите описание товара, чтобы использовать его для создания схожего товара.

• /v1/product/info/discounted — получите информацию об уценке и основном товаре по SKU уценённого товара.

1. /v2/products/delete — удалите товар, если он загрузился с ошибкой и попал в архив без SKU. Товары, которые успешно прошли модерацию и получили SKU, удалить из архива нельзя.

2. /v1/product/archive — перенесите товар в архив. Перед архивированием товара обнулите его остатки.

3. /v1/product/unarchive — верните товар из архива.

Товар попадёт в продажу, только когда вы установите его остаток.

Загрузить коды активации для услуг и цифровых товаров можно через метод /v1/product/upload_digital_codes.

• Получите список типов сертификатов: /v1/product/certificate/types.
• Получите список сертифицируемых категорий: /v2/product/certification/list.
• Получите список статусов сертификата: /v1/product/certificate/status/list.
• Получите список типов соответствия требованиям: /v2/product/certificate/accordance-types/list.
• Получите список причин отклонения сертификата: v1/product/certificate/rejection_reasons/list.
• Получите список сертификатов: v1/product/certificate/list, используя фильтры:
  • тип сертификата type — значение value из ответа /v1/product/certificate/types;
  • статус сертификата status — значение code из ответа v1/product/certificate/status/list.

Чтобы привязать сертификат к товару:

1. Получите список брендов, для которых требуется предоставить сертификат: /v1/brand/company-certification/list. В ответе вернутся бренды, товары которых есть в вашем личном кабинете. Список брендов может изменяться, если Ozon получит требование от бренда предоставлять сертификат.
2. Добавьте сертификаты для товаров: /v1/product/certificate/create.
3. Привяжите сертификат к товару: /v1/product/certificate/bind.

Чтобы посмотреть список товаров, привязанных к сертификату, воспользуйтесь методом v1/product/certificate/products/list. Если нужно получить список товаров с определённым статусом, в параметре status передайте значение code из ответа v1/product/certificate/product_status/list.

Чтобы отвязать товар от сертификата, используйте /v1/product/certificate/products/unbind.

Чтобы получить атрибуты для управления сертификатом:

1. Получите список типов сертификатов: /v1/product/certificate/types.
2. Получите список типов соответствия требованиям: /v2/product/certificate/accordance-types/list.

Для создания сертификата используйте /v1/product/certificate/create, передав в запросе:

• тип сертификата type_code — значение value из ответа /v1/product/certificate/types;
• тип соответствия требованиям accordance_type_code — значение code из ответа /v2/product/certificate/accordance-types/list.

Чтобы удалить сертификат, используйте /v1/product/certificate/delete.

После загрузки товаров для схем FBS и rFBS можно перейти к обновлению остатков. Для схемы FBO остатки обновляются автоматически по факту продажи.

Для обновления остатков используйте методы:

• /v1/product/import/stocks — если у вас заведён один склад.
• /v2/products/stocks — если складов несколько. В этом методе дополнительно указывается идентификатор склада, на котором необходимо изменить остатки.

Для получения информации о количестве остатков для FBO используйте /v3/product/info/stocks.

Для получения информации о количестве остатков для FBS и rFBS используйте v1/product/info/stocks-by-warehouse/fbs.

Чтобы обновить цены по товарам и не менять карточку товара, используйте /v1/product/import/prices.

Метод позволяет обновить цену:

• до скидок,
• для клиентов с подпиской Ozon Premium,
• на карточке товара с учётом скидок,
• минимальную цену товара после применения акций.

Для получения информации о ценах, комиссиях и скидках на товары используйте /v5/product/info/prices.

Если товары заказывают юридические лица, оплата может поступать не сразу — система зарезервирует товары. Чтобы проверить остатки, используйте методы /v3/posting/fbs/get, /v3/posting/fbs/list или /v3/posting/fbs/unfulfilled/list. Если в ответе is_legal = true, значит среди остатков есть зарезервированные товары. Вы можете обновить остатки так, чтобы новое количество товаров было больше свободного остатка и зарезервированного товара в сумме. Система спишет старый остаток и рассчитает новый.

Чтобы проверить резервирование товара, используйте метод /v3/product/info/stocks.

Подробнее об изменении остатков

Для продвижения товаров участвуйте в акциях, которые Ozon проводит для покупателей.

• Получите список доступных акций: /v1/actions.

• Получите список товаров, которые могут участвовать в акции: /v1/actions/candidates.

• Добавьте товары в акцию: /v1/actions/products/activate.

• Получите список товаров, которые участвуют в акции: /v1/actions/products.

• Удалите товары из акции: /v1/actions/products/deactivate.

Покупатели могут попросить у вас скидку на товар. Чтобы получить список товаров, которые покупатели хотят купить со скидкой, воспользуйтесь методом /v1/actions/discounts-task/list. Заявки в статусах NEW (новые) или SEEN (просмотренные) вы можете:

• одобрить — используйте метод /v1/actions/discounts-task/approve,
• отклонить — используйте метод /v1/actions/discounts-task/decline.

Подробнее об акциях в Базе знаний продавца

Стратегии ценообразования — инструмент для автоматического изменения стоимости товаров в соответствии с ценами на аналогичные товары в других интернет-магазинах и маркетплейсах.

Подробнее о стратегиях в Базе знаний для продавцов из России

Подробнее о стратегиях в Справке для продавцов Ozon Global

Чтобы настроить стратегии ценообразования:

1. Получите список конкурентов: /v1/pricing-strategy/competitors/list.

2. Получите список стратегий ценообразования: /v1/pricing-strategy/list.

3. Создайте свою стратегию: /v1/pricing-strategy/create и установите коэффициенты, чтобы изменять стоимость товара по сравнению с другими площадками в большую и меньшую сторону. Чтобы получить информацию о стратегии, используйте метод /v1/pricing-strategy/info.

4. Добавьте товары в стратегию: /v1/pricing-strategy/products/add.

   Вы можете добавить товары:

   • На которые установлена минимальная цена с помощью метода /v1/product/import/prices. Чтобы проверить цену, используйте метод /v5/product/info/prices.
   • Которые не привязаны к другой стратегии. Чтобы проверить привязку товара к стратегии, используйте метод /v1/pricing-strategy/strategy-ids-by-product-ids.

   Чтобы получить список товаров, которые привязаны к стратегии, используйте метод /v1/pricing-strategy/products/list, а для удаления товаров из стратегии — /v1/pricing-strategy/products/delete.

5. Включите или отключите стратегию: /v1/pricing-strategy/status.

Чтобы изменить список выбранных конкурентов и название стратегии, используйте метод /v1/pricing-strategy/update.

Для удаления стратегии используйте метод /v1/pricing-strategy/delete.

• /v1/delivery-method/list — получите список методов склада.

• /v1/warehouse/list — получите список складов.

Обработайте заказы в зависимости от схемы работы:

• cхема FBO;
• стандартная схема FBS;
• схема FBS PickUp с подключённой доверительной приёмкой;
• стандартная схема rFBS;
• схема rFBS Express с доставкой в пункт выдачи;
• схема rFBS с доставкой через интегрированную службу;
• схема rFBS Агрегатор.

Если вы продаёте товары из-за рубежа, обрабатывайте заказы по одной из схем:

• rFBS Crossborder;
• rFBS Crossborder с интегрированной службой доставки;
• rFBS Агрегатор.

Подробнее о заказах с весовыми товарами при работе по схеме rFBS

Перед созданием заявки на поставку проверьте загруженность складов Ozon: /v1/supplier/available_warehouses.

Для получения списка отправлений, финансовой и аналитической информации используйте /v2/posting/fbo/list. Также метод возвращает информацию о проданных кодах активации с привязкой к номеру отправления.

Чтобы получить информацию по отправлению, используйте /v2/posting/fbo/get.

Создать заявку на поставку

1. /v1/cluster/list — получите информацию по кластерам и их складам.
2. /v1/warehouse/fbo/list — получите идентификаторы складов, пунктов выдачи заказов и сортировочных центров для отгрузки кросс-докингом.
3. /v1/draft/create — создайте черновик заявки на поставку. Для этого передайте список поставляемых товаров, тип поставки и, при доставке кросс-докингом, точку отгрузки.
4. /v1/draft/create/info — получите статус создания черновика и информацию по нему.
5. /v1/draft/timeslot/info — получите доступные таймслоты для конечных складов отгрузки. Максимальный период — 28 дней, начиная с текущей даты.
6. /v1/draft/supply/create — создайте заявку на поставку по черновику.
7. /v1/supply/create/status — получите статус создания заявки на поставку. Когда заявка будет создана, метод вернёт идентификаторы заявок на поставку.

Получите информацию о заявках на поставку

Для поставки на фулфилмент Ozon нужна заявка. В ней указано, какие товары и в каком количестве вы привезёте.

1. /v2/supply-order/list — получите список заявок на поставку.
2. /v1/supply-order/status/counter — получите статус заявки и количество поставок в этом статусе.
3. /v2/supply-order/get — получите информацию по заявке.
4. v1/supply-order/bundle — получите состав поставки или заявки на поставку.

Для проезда на фулфилмент выберите интервал поставки и оформите пропуск для водителя и автомобиля. Для этого:

1. /v1/supply-order/timeslot/get — получите список доступных интервалов.
2. /v1/supply-order/timeslot/update — измените выбранный интервал.
3. /v1/supply-order/timeslot/status — получите статус закрепления интервала.
4. /v1/supply-order/pass/create — добавьте данные водителя и автомобиля.
5. /v1/supply-order/pass/status — получите статус ввода данных о водителе и автомобиле.

Управляйте грузоместами в заявке на поставку

1. /v1/cargoes/create — передайте количество грузомест и установите в каждое грузоместо товарный состав.
2. /v1/cargoes/create/info — получите информацию по установке грузомест и товарного состава.
3. /v1/cargoes-label/create — создайте задание на формирование этикеток грузомест.
4. /v1/cargoes-label/get — получите статус создания этикеток и идентификатор файла с ними.
5. /v1/cargoes-label/file/{file_guid} — получите PDF с этикетками грузовых мест.

1. Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   Получите идентификаторы экземпляров exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.

5. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

6. Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

7. Подтвердите отгрузку и запустите формирование транспортной накладной методом /v2/posting/fbs/act/create или создайте отгрузку с помощью метода /v1/carriage/create и подтвердите её методом /v1/carriage/approve. В ответе методов /v2/posting/fbs/act/create и /v1/carriage/create вы получите идентификатор созданной перевозки.

8. Запросите информацию о созданной поставке с помощью метода /v1/carriage/get. Массив available_actions содержит информацию о доступных действиях с поставкой и необходимости создать пропуск для проезда на склад Ozon.

   Чтобы создать пропуск, используйте метод /v1/carriage/pass/create. Чтобы после поставки товаров вы могли забрать возвраты на этой же машине, передайте значение with_returns = true. Для каждой поставки нужен новый пропуск.

   Для редактирования или удаления пропуска используйте методы /v1/carriage/pass/update и /v1/carriage/pass/delete.

   Список всех пропусков можно получить с помощью метода /v1/pass/list.

   Подробнее об оформлении пропусков

9. Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list или /v1/carriage/delivery/list.

10. Проверьте, что отгрузка создана: /v2/posting/fbs/act/check-status.

11. Получите штрихкод для отгрузки: /v2/posting/fbs/act/get-barcode.

12. Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status. Когда статус документа перейдёт в FORMED, получите файлы:

    • Транспортная накладная: /v2/posting/fbs/act/get-pdf.
    • Лист отгрузки: /v2/posting/fbs/digital/act/get-pdf.

После этого можете отвезти отправления и документы в пункт приёма.

Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть спор: /v2/posting/fbs/arbitration. Открытый спор переведёт отправление в статус arbitration.

Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.

Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.

Для передачи спорных заказов к отгрузке используйте /v2/posting/fbs/awaiting-delivery. Статус отправления изменится на awaiting_deliver.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

Работа с эконом-товарами

1. Создайте эконом-товары в личном кабинете.
2. Получите идентификаторы квантов с созданными товарами: /v1/product/quant/list.
3. Отслеживайте количество заказанных товаров: /v1/quant/get.
4. Когда наберётся нужное для кванта количество заказанных товаров, соберите его: v1/quant/ship.

Подробнее об эконом-товарах в Справке

1. Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.

5. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

6. Подтвердите отгрузку и запустите формирование транспортной накладной методом /v2/posting/fbs/act/create или создайте перевозку с помощью метода /v1/carriage/create и подтвердите её методом /v1/carriage/approve. В ответе методов /v2/posting/fbs/act/create и /v1/carriage/create вы получите идентификатор созданной перевозки.

7. Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list или /v1/carriage/delivery/list.

8. Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status. Когда статус документа перейдёт в FORMED, получите файлы:

   • Транспортная накладная: /v2/posting/fbs/act/get-pdf.
   • Лист отгрузки: /v2/posting/fbs/digital/act/get-pdf.

9. Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

10. После того как вы упаковали все отправления по требованиям из раздела Доверительная приёмка грузового места в Базе знаний продавца, получите этикетки на каждое грузовое место: /v2/posting/fbs/act/get-container-labels.

После этого можете передать грузовое место в пункт приёма или курьеру Ozon.

Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть спор: /v2/posting/fbs/arbitration. Открытый спор переведёт отправление в статус arbitration.

Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.

Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.

Для передачи спорных заказов к отгрузке используйте /v2/posting/fbs/awaiting-delivery. Статус отправления изменится на awaiting_deliver.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
   Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

   Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода /v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list, /v3/posting/fbs/list или /v3/posting/fbs/get. После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

Когда сборка заказа завершена, свяжитесь с покупателем для согласования даты доставки. Если покупателю не подходит дата, вы можете перенести её: /v1/posting/fbs/timeslot/set. Посмотрите доступные даты для переноса доставки и количество доступных переносов: /v1/posting/fbs/timeslot/change-restrictions.

Передайте отправление курьеру:

1. Когда курьер забрал отправление, измените статус отправления на «Доставляется»: /v2/fbs/posting/delivering.

   Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.

2. Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.

3. Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

5. Распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

6. Передайте отправление курьеру.

Дальше подстатусы будут изменяться автоматически:

1. on_way_to_city — курьер забрал заказ.
2. on_way_to_pickup_point — курьер везёт заказ в пункт выдачи.
3. in_pickup_point — отправление приняли в пункте выдачи.
4. delivered — покупатель забрал заказ из пункта выдачи.

Чтобы проверить статус отправления, используйте метод /v3/posting/fbs/list.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. Если товар в отправлении упакован в несколько коробок, передайте их количество: /v3/posting/multiboxqty/set. Если не сделать этого до сборки, вам придётся объединить все коробки в одну.

5. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_registration.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

6. Когда перевозчик обработает отправление, его статус изменится с awaiting_registration на awaiting_delivery. После этого отправлению будет присвоен трек-номер.

   Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

   Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.

Если вы продаёте из Турции и вам нужны декларации Elektronik Ticaret Gümrük Beyannamesi (ETGB) для возврата налоговой пошлины, получите декларации: /v1/posting/global/etgb.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
   Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

   Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода /v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list, /v3/posting/fbs/list или /v3/posting/fbs/get. После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

5. Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените статус отправления на sent_by_seller — «Отправлено продавцом»: /v2/fbs/posting/sent-by-seller.

6. После передачи отправления в службу доставки измените статус отправления на delivering — «Доставляется»: /v2/fbs/posting/delivering.

7. Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.

8. Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.

9. Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
   Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

5. Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

6. Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените статус отправления на sent_by_seller — «Отправлено продавцом»: /v2/fbs/posting/sent-by-seller.

Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

Перед тем, как перевести заказ с весовыми товарами в статус «Ожидает отгрузки» — awaiting_delivery, передайте уточнённые данные о весе весовых товаров. Для этого после взвешивания во время сборки передайте информацию о весе каждого экземпляра каждого весового SKU через метод /v2/posting/fbs/product/change.

Товар необходимо взвешивать, если при создании товара вы указали, что товар весовой, и добавили к нему атрибуты 20577, 8933 и 8934.

После передачи корректного веса для всех экземпляров всех весовых товаров вы сможете перевести отправление в статус «Ожидает отгрузки» — awaiting_delivery.

API вернёт ошибку 400, если вы:

• взвесили не все экземпляры из отправления,
• передали значение веса для невесового товара,
• вес экземпляра не попал в диапазон заданный атрибутами 8933 и 8934.

• /v2/posting/fbs/act/list — получите список сформированных ранее актов.
• /v2/posting/fbs/act/get-postings — получите список отправлений по каждому акту.

/v1/returns/list — получите информацию о возвращённых товарах.

Убедитесь, что вы можете получать возвратные отгрузки по штрихкоду: /v1/return/giveout/is-enabled. Если у вас есть доступ, в параметре enabled будет указано значение true.

Чтобы получить возвратную отгрузку, запросите штрихкод:

• /v1/return/giveout/get-pdf — получить штрихкод в формате PDF.
• /v1/return/giveout/get-png — получить штрихкод в формате PNG.
• /v1/return/giveout/barcode — получить штрихкод в текстовом виде.

Получите информацию и список возвратных отгрузок:

• /v1/return/giveout/list — получить список возвратных отгрузок.
• /v1/return/giveout/info — получить информацию о выбранной отгрузке.

Вы можете забрать возвраты отдельно от поставки товаров. Если для проезда на склад Ozon нужен пропуск, создайте его с помощью метода /v1/return/pass/create. Для каждого проезда за возвратами нужен новый пропуск.

Для редактирования и удаления пропуска используйте методы /v1/return/pass/update и /v1/return/pass/delete.

Список всех пропусков можно получить с помощью метода /v1/pass/list.

Подробнее об оформлении пропусков

Получите заявки и информацию о них:

• /v2/returns/rfbs/get — получите информацию по заявке на возврат rFBS.
• /v2/returns/rfbs/list — получите список заявок на возврат rFBS.

Примите решение по заявке и возврату денег:

• /v2/returns/rfbs/verify — одобрите заявку с возвратом полной стоимости товара. Подтвердите возврат денег с помощью метода /v2/returns/rfbs/return-money.
• /v2/returns/rfbs/compensate — компенсируйте частичную стоимость товара и оставьте его у покупателя.
• /v2/returns/rfbs/reject — отклоните заявку на возврат rFBS.

Запросите у покупателя товар для проверки и подтвердите получение товара с помощью метода /v2/returns/rfbs/receive-return.

Получите заявки и информацию о них:

• /v1/conditional-cancellation/get — получите информацию по заявке на отмену rFBS.
• /v1/conditional-cancellation/list — получите список заявок на отмену rFBS.

Примите решение по новой заявке на отмену — подтвердите или отклоните её:

• /v1/conditional-cancellation/approve — подтвердите заявку на отмену rFBS. Заказ будет автоматически отменён, а деньги вернутся покупателю.
• /v1/conditional-cancellation/reject — отклоните заявку на отмену rFBS. Заказ останется в том же статусе, и его нужно будет доставить покупателю.

Для получения списка чатов используйте /v2/chat/list. В ответе будут идентификаторы текущих чатов и последних сообщений.

Для отправки сообщений по идентификатору чата используйте методы:

• /v1/chat/send/message — для отправки текстового сообщения.

• /v1/chat/send/file — для отправки файла или изображения.

Для получения истории чата по идентификатору чата или сообщения используйте метод /v2/chat/history. Направление сортировки по умолчанию — от новых сообщений к старым.

Если указать идентификатор сообщения, то история начнётся с этого сообщения.

Чтобы создать новый чат с покупателем по номеру отправления, воспользуйтесь /v1/chat/start.

Чтобы отметить сообщение и все сообщения до него прочитанными, используйте /v2/chat/read.

При запросе любого из отчётов сначала возвращается код на создание документа. Отправьте его в запросе метода /v1/report/info — в ответе вернётся файл отчёта и дополнительная информация.

Чтобы получить список сформированных ранее отчётов, используйте /v1/report/list.

Методы для получения отчётов:

• /v1/report/products/create — отчёт с данными о товарах, например Ozon ID, описанием товара, цены, комиссии или габаритов упаковки.

• /v3/finance/transaction/list — отчёт по транзакциям, доступный в личном кабинете продавца.

• /v4/product/info/price — отчёт по ценам.

• /v1/report/warehouse/stock — отчёт по остаткам на складе.

• /v2/report/returns/create — отчёт о возвращённых товарах для FBS и rFBS. Отчёт содержит товары, принятые от покупателя, готовые к получению или переданные продавцу.

• /v1/report/postings/create — отчёт об отправлениях.

• /v1/finance/cash-flow-statement/list — финансовый отчёт.

• /v1/report/discounted/create — отчёт об уценённых товарах.

• /v1/analytics/data — получите данные аналитики.

  Если укажете период и метрики, которые нужно рассчитать, в ответе будет аналитиĸа, сгруппированная по параметру dimensions.

• /v1/analytics/stocks — получите аналитику по остаткам товаров на складах.

Чтобы получить отчёт по оборачиваемости FBO, запросите его в личном кабинете.

• /v3/finance/transaction/list — получите подробную информацию по транзакциям для отправления.

• /v3/finance/transaction/totals — получите детальную информацию по итоговым суммам транзакций за указанный период.

• /v1/rating/summary — получите текущие значения рейтингов продавца.

• /v1/rating/history — получите информацию о рейтингах продавца за период и количество штрафных баллов, начисленных в Premium-программе.